home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 480.lha / SmartField / Docs / Lattice Instructions.pp / Lattice Instructions
Encoding:
Text File  |  1991-02-11  |  6.1 KB  |  191 lines
  1. 1)  COMPLETE REGISTRATION CARD
  2.  
  3.     Does not apply.
  4.  
  5.  
  6. 2)  MAKE BACKUP COPY
  7.  
  8.     Before going any further, make a backup copy of your SmartFields
  9.     diskette.  Consult your Amiga manual if you are unfamiliar with the
  10.     procedure for copying diskettes.  Place your original SmartFields
  11.     diskette in a safe place and use your backup copy for all procedures
  12.     listed below.
  13.  
  14.  
  15. 3)  INSTALL CONSOLE INCLUDE FILES
  16.  
  17.     You need to install your SmartFields include files.  Include files are
  18.     the files that you read during compilation, for example
  19.  
  20.         #include <intuition/intuition.h>
  21.  
  22.     Using the CLI dir command, display the include: directory:
  23.  
  24.         dir include:
  25.  
  26.     This directory should contain numerous subdirectories, including:
  27.  
  28.         devices (dir)
  29.         exec (dir)
  30.         graphics (dir)
  31.         hardware (dir)
  32.         intuition (dir)
  33.         workbench (dir)
  34.         ...
  35.  
  36.     The Amiga include files are stored in subdirectories as listed above.
  37.     This is where you will install your SmartFields include files.
  38.  
  39.     SPECIAL NOTE: If you store your include files in ram: or on a sticky-RAM
  40.     disk, you will need to find the include directory on your startup
  41.     diskette and install the include files there as well.  Otherwise, any
  42.     files you install only on your RAM disk will be lost when you shut off
  43.     your Amiga.
  44.  
  45.     Change directories so you are now in the include directory containing all
  46.     of the subdirectories as listed above:
  47.  
  48.         cd include:
  49.  
  50.     Now make a new directory called console:
  51.  
  52.         makedir console
  53.  
  54.     Copy the three SmartFields include files provided on your SmartFields
  55.     diskette to the console directory you've just created:
  56.  
  57.         copy SmartFields:include/console/#? console/
  58.  
  59.     Now display the contents of the console directory:
  60.  
  61.         dir console
  62.  
  63.     If all went well, it should contain the following include files:
  64.  
  65.         console.h
  66.         fields.h
  67.         functions.h
  68.  
  69.  
  70. 4)  INSTALL TOOLKIT INCLUDE FILES
  71.  
  72.     WARNING!! If you are already using another Software Ingenuity product--
  73.     the C Toolkit--you will have already installed a toolkit.h include file.
  74.     If this is the case, do NOT execute this step (step 4)!
  75.  
  76.     Make a new directory called toolkit:
  77.  
  78.         makedir toolkit
  79.  
  80.     Copy the toolkit.h include file provided on your SmartFields diskette to
  81.     the toolkit directory you've just created:
  82.  
  83.         copy SmartFields:include/toolkit/toolkit.h toolkit/
  84.  
  85.     Now display the contents of the toolkit directory:
  86.  
  87.         dir toolkit
  88.  
  89.     If all went well, it should contain the following file:
  90.  
  91.         toolkit.h
  92.  
  93.  
  94. 5)  COMPILE SMARTFIELDS FUNCTIONS
  95.  
  96.     A batch file has been provided that will compile all 70 SmartFields
  97.     functions for you.  The file is named compile.lattice and is located in
  98.     the Lattice directory on your SmartFields diskette.  Load the
  99.     compile.lattice file into your favorite text editor.  You will notice a
  100.     compilation line for each SmartFields function.  Every function is
  101.     compiled using the lc command and the -v flag to inhibit stack checking.
  102.  
  103.     If you wish to compile the functions under different conditions, you need
  104.     to add your own compiler flags (or remove the -v flag if desired).  As an
  105.     example, let's say you want to remove the -v flag to enable stack
  106.     checking.  Place the cursor at the top of the compile.lattice file and
  107.     execute your text editor's search/replace function.  When it asks you
  108.     which text you want to search for, type
  109.  
  110.         lc -v
  111.  
  112.     When it asks you which text you want to replace it with, type
  113.  
  114.         lc
  115.  
  116.     In essence, this will remove the -v flag from all compiler calls.
  117.  
  118.     If you made any changes, save the compile.lattice file back to disk.  To
  119.     begin compilation, type at the CLI:
  120.  
  121.         execute SmartFields:lattice/compile.lattice
  122.  
  123.     This will compile all SmartFields functions, creating a ".o" object file
  124.     for each ".c" source file.  The batch file will stop executing if any of
  125.     the functions have a compiler error.  On the other hand, compiler
  126.     warnings will be displayed, but the batch file will NOT stop executing.
  127.  
  128.     All 70 SmartFields functions will compile successfully using Lattice
  129.     compiler versions 3.10 and 4.00 with the supplied compile.lattice batch
  130.     file.
  131.  
  132.  
  133. 6)  CREATE SMARTFIELDS LIBRARY
  134.  
  135.     Now that you've compiled all of the SmartFields functions, you need to
  136.     build them into a library to be linked with your C programs.  To do this,
  137.     type at the CLI:
  138.  
  139.         execute SmartFields:lattice/library.lattice
  140.  
  141.     This will create a library called sf.lib in the Lattice directory of your
  142.     SmartFields diskette.
  143.  
  144.     You now need to copy this library into the directory which contains the
  145.     other link-time libraries such as lc.lib and lcm.lib.  At the CLI, type:
  146.  
  147.         copy SmartFields:lattice/sf.lib lib:
  148.  
  149.     Again, if lib: points to a directory in ram: or in a sticky-RAM disk, you
  150.     will need to find the library directory on your startup diskette and
  151.     install the SmartFields library there as well.  Any files you install
  152.     only on your RAM disk will be lost when you shut off your Amiga.
  153.  
  154.  
  155. 7)  CONGRATULATIONS!
  156.  
  157.     You are now ready to incorporate the SmartFields system in your own
  158.     programs!  An example program is supplied just to get you familiar with
  159.     how you would go about using the SmartFields library.  If you would like
  160.     a little practice, read on...
  161.  
  162.  
  163. 8)  EXAMPLE PROGRAM
  164.  
  165.     Change the current directory to the example program directory:
  166.  
  167.         cd SmartFields:programs/example
  168.  
  169.     The program labeled e.c is the example program discussed in the "Creating
  170.     a SmartFields Program" section of the manual.  To compile the program and
  171.     link it with the SmartFields library, type at the CLI:
  172.  
  173.         lc -L+lib:sf.lib e.c
  174.  
  175.     NOTE: If you added any flags to the compiler commands in the
  176.     compile.lattice batch file, you may need to add them here as well!
  177.  
  178.     To run the example program, type at the CLI:
  179.  
  180.         e
  181.  
  182.     See page 10 in the manual for more information on this program.  To end
  183.     the program, click on the window's close gadget.
  184.  
  185.  
  186. Lattice Instructions  01/13/90
  187. © Copyright 1990 Timm Martin
  188. All Rights Reserved Worldwide
  189.  
  190. /*-- END --*/
  191.